import { Tabs, Tab, PackageManagerTabs } from '@theme';

# 快速开始

## 环境准备

在开始使用前，你需要安装 [Node.js](https://nodejs.org/)，并保证 Node.js 版本 >= 20，**我们推荐使用 Node.js 20 的 LTS 版本**。

你可以通过以下命令检查当前使用的 Node.js 版本：

```bash
node -v
```

如果你当前的环境中尚未安装 Node.js，或是安装的版本过低，可以通过 [nvm](https://github.com/nvm-sh/nvm) 或 [fnm](https://github.com/Schniz/fnm) 安装需要的版本。

下面是通过 nvm 安装 Node.js 20 LTS 版本的例子：

```bash
# 安装 Node.js 20 的长期支持版本
nvm install 20 --lts

# 将刚安装的 Node.js 20 设置为默认版本
nvm alias default 20

# 切换到刚安装的 Node.js 20
nvm use 20
```

## 创建 EMP 项目

你可以使用 `create-emp` 来创建一个 EMP 项目，调用以下命令：

<PackageManagerTabs command="create emp@latest" />


然后按照提示操作即可，你可以选择 `create-emp` 提供的下列模板：

| 模板    | 描述                            | 可选功能   |
| ------- | ------------------------------- | ---------- |
| react   | [React 18](https://react.dev/)  | TypeScript |
| vue3    | [Vue 3](https://vuejs.org/)     | TypeScript |
| vue2    | [Vue 2](https://v2.vuejs.org/)  | TypeScript |


## 命令行工具

`EMP` CLI 内置了一个轻量的命令行工具，包含 dev、build 等命令。

```json title="package.json"
{
  "scripts": {
    // 启动开发服务器
    "dev": "emp dev",
    // 构建用于生产的应用
    "build": "emp build",
    // 在本地预览生产版本
    "start": "emp serve",
    // 包体积分析
    "stat": "emp build --analyze",
  }
}
```

请参考 [CLI 工具] 来了解所有可用的命令以及选项。

## 入口模块

`EMP` CLI 默认会使用 `src/index.(js|ts|jsx|tsx)` 作为入口模块，你可以使用 [entry] 配置项来修改入口模块。
